The following table shows the connections to control the operation of the EmailSender ActiveX control at run time.
Connections |
Descriptions |
Trigger Required |
When the assigned tag transitions from a zero to non-zero value, the control reads the values of the other connections and attempts to send an email. The connection can be a tag, tag placeholder "{#1}", or expression. |
SMTPSrvrAddress Required |
This connection contains the server name (for example, smtp.gmal.com) or IP address of the SMTP Server (for example, 200.71.232.10). The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "smtp.gmail.com"). |
SMTPPort Required |
This connection contains the TCP/IP port (for example, 25) used to communicate with the SMTP server. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "25"). |
SMTPUserID Optional |
This connection contains the user id (for example, myusername) to be used to authenticate with a SMTP server that requires authentication. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "myusername"). |
SMTPUserPwd Optional |
This connection contains the password associated with the user ID, contained in SMTPUserId (for example, P@as5word), to be used to authenticate with a SMTP server that requires authentication. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "P@as5word"). |
SSLEnable Optional |
When the value is non-zero, the SMTP Email control uses Secure Socket Layer (SSL) protocol to communicate with the SMTP Server. When the value is zero or blank, the SMTP Email control does not use Secure Socket Layer (SSL) protocol to communicate with the SMTP Server. The connection data type is String. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "True"). |
SendAnonymous Optional |
When the value is non-zero, the SMTP Email control does not attempt to authenticate with the SMTP Server before attempting to send an email. When sending an email, anonymously SMTPUserId and SMTPUserPwd should be left blank. When the value is zero or blank, the SMTP Email control authenticates with the SMTP Server using the credentials contained in SMTPUserId and SMTPUserPwd. The connection data type is String. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "True"). |
From_Address Required |
This connection contains the email address of the sender (for example, myEmail@emaildomain.com). The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "myEmail@emaildomain.com"). |
From_Name Optional |
This connection contains the name of the sender (for example, "Palletizer 22B", "PanelView Plus Alarm", or "Fred") The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred"). |
TO_Address Optional |
This connection contains the TO recipients of the email (for example, Fred@att.net). Comma separate the individual emails if a list is desired. At least one email address among the TO_address, CC_address, and BCC_address connections must contain a valid email address or the send operation will fail. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred@emaildomain.com"). |
CC_Address Optional |
This connection contains the CC recipients of the email (for example, Fred@att.net). Comma separate the individual emails if a list is desired. At least one email address among the TO_address, CC_address, and BCC_address connections must contain a valid email address or the send operation will fail. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred@emaildomain.com"). |
BCC_Address Optional |
This connection contains the BCC recipients of the email (for example, Fred@att.net). Comma separate the individual emails if a list is desired. At least one email address among the TO_address, CC_address, and BCC_address connections must contain a valid email address or the send operation will fail. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred@emaildomain.com"). |
Subject Optional |
This connection contains the subject (for example, Alarm email) of the email being sent. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Alarm Email"). |
Body Optional |
This connection contains the body (for example, The level of the tank is 100 psi) of the email being sent. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "The level of the tank is 100 psi."). |
BodyFile Optional |
This connection contains the path (for example, C:\SMTP Files\ALARM.TXT) to a text file containing the body of the email. When the email is sent the control reads specified text file and sends that content as the email body. Only simple text (.txt) files are supported. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "\my documents\alarm.txt"). |
AttachmentFile Optional |
This connection contains the path (for example, C:\SMTP Files\ALARM.TXT) to a file to be attached to the email. When the email is sent the control reads specified file path and attaches the file to the email. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "\my documents\readings.csv"). |
AttachmentFailure Optional |
When this value is non-zero and the file specified in AttachmentFile cannot be attached to the email, this connection causes the email send operation to fail. The connection data type is String. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "\my documents\readings.csv"). |
Signature Optional |
This connection contains the signature (for example, Palletizer 22B or Fred Smith) of the email being sent. The connection data type is String. The maximum length is 82 characters. The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred Smith"). |
Handshake Optional |
When triggered the control writes the status of the email send operation. Non-zero result indicates success. Zero result indicates failure. The connection data type is Integer. The connection can be a tag or tag placeholder "{#1}". |
FailureCode Optional |
When a send attempt fails the control writes a string message to this connection indicating the cause of the failure. The connection data type is String. The connection can be a tag or tag placeholder "{#1}". |
If failed in sending an attachment that is smaller than 10 MB